fputc[write a character on a stream or file]

Contents|Index|Previous|Next

fputc
[write a character on a stream or file]

SYNOPSIS
#include <stdio.h>
int fputc(int ch, FILE *fp);

DESCRIPTION
fputc converts the argument ch from an int to an unsigned char, then writes it to the file or stream identified by fp.

If the file was opened with append mode (or if the stream cannot support positioning), then the new character goes at the end of the file or stream. Otherwise, the new character is written at the current value of the position indicator, and the position indicator advances by one.

For a macro version of this function, see putc.

RETURNS
If successful, fputc returns its argument, ch. If an error intervenes, the result is EOF. You can use ferror(fp) to query for errors.

COMPLIANCE
fputc is required by ANSI C.

Supporting OS subroutines required: close, fstat, isatty, lseek, read, sbrk, write.